Contents page

ARexx Interface

 AREXX-INTERFACE 


 YAM besitzt eine ARexx-Schnittstelle, die es anderen Programmen erlaubt,
 Funktionen von YAM zu benutzen. Der Portname dieser Schnittstelle ist
 'YAM'.



 BEFEHLS-REFERENZ


 _________________________Standardbefehle von MUI_______________________


 quit
 Beendet YAM.


 hide
 Schaltet YAM in den ikonifizierten Modus.


 show
 Kehrt vom ikonifizierten Modus zurück.


 info          ITEM/A
 Gibt Informationen über YAM in der Variable RESULT zurück.
 ITEM ist eines der folgenden Schlüsselwörter:
   TITLE       Programmtitel
   AUTHOR      Name des Autors
   COPYRIGHT   Copyright-Information
   DESCRIPTION Kurzbeschreibung
   VERSION     Programmversion
   BASE        Name des ARexx Ports
   SCREEN      Name des öffentlichen Bildschirms


 help          FILE/A
 Schreibt eine Liste aller unterstützten ARexx-Befehle in eine Datei.



 ___________________________Abholen neuer Post__________________________


 mailcheck
 Entspricht dem Knopf [Post holen]. RESULT enthält die Anzahl der neuen
 Nachrichten oder -1, falls die Verbindung zum Mailserver nicht zustande
 kam.


 mailfilter    ALL/S
 Filtert die Nachrichten im Posteingang. Ohne den Schalter ALL werden nur
 neue Nachrichten gefiltert. RESULT enthält die Anzahl der geprüften,
 weitergeleiteten, archivierten und gelöschten Nachrichten, z.B. '12 0 3 0'



 _______________________Bearbeiten von Nachrichten______________________


 setfolder     FOLDER/N/A
 Wechselt das aktive Postfach. FOLDER muss ein gültiger Name eines Postfachs
 oder eine Zahl im Bereich von 0 (Eingang) bis 3-19 (Archivpostfächer) sein.


 setmail       NUM/N/A
 Bestimmt die aktive Nachricht im aktiven Postfach. Der Wert von NUM
 liegt im Bereich 0 bis (Anzahl Einträge-1).


 getfolderinfo INFO/A
 Gibt Information zum aktiven Postfach in der Variable RESULT zurück.
 INFO ist eines der folgenden Schlüsselwörter:
   NUM(BER)  Nummer (0=Eingang, 1=Ausgang, etc.)
   NAM(E)    Name des Postfachs
   PAT(H)    Verzeichnispfad des Postfachs
   MAX       Anzahl Nachrichten


 getmailinfo   INFO/A
 Gibt Information zur angewählten Mail in der Variable RESULT zurück.
 INFO ist eines der folgenden Schlüsselwörter:
   ACT(IVE)  Nummer (0=erste im Postfach)
   STA(TUS)  Status der Mail (1 Zeichen)
   FRO(M)    Absender
   TO        Primärer Empfänger
   REP(LYTO) Rückantwortadresse
   SUB(JECT) Betreff
   FIL(E)    Voller Pfad der Maildatei


 mailreply
 Entspricht dem Knopf [Antworten].


 mailforward
 Entspricht dem Knopf [Weiterleiten].


 mailarchive   FOLDER/A
 Entspricht dem Knopf [Archivieren]. FOLDER muss der Name eines Archiv-
 postfachs oder eine Zahl im Bereich von 3 bis 51 sein.


 maildelete
 Entspricht dem Knopf [Löschen].



 ___________Zusammenstellen und Versenden von Nachrichten_______________


 mailwrite
 Entspricht dem Knopf [Schreiben].


 writemailto   ADDRESS/A/M
 Eine oder mehrere Email-Adressen (Alias und Namen sind ebenfalls
 erlaubt), welche ins Textfeld "An" im Schreiben-Fenster eingetragen
 werden.


 writesubject  TEXT/A
 Betreff der Nachricht.


 writeattach   FILENAME/A,DESC,ENCMODE,CTYPE
 Fügt FILENAME zur Beilagenliste; im optionalen Parameter DESC steht die
 Beschreibung, ENCMODE ist entweder MIME oder UU und CTYPE enthält den
 MIME-Inhaltstyp für diese Datei.


 writeletter   FILENAME/A
 Datei mit dem zu verschickenden Text.


 writequeue
 Entspricht dem Knopf [Warteschlange] im Schreiben-Fenster.


 writesend
 Entspricht dem Knopf [Jetzt senden] im Schreiben-Fenster.


 mailsend
 Entspricht dem Knopf [Senden] im Postausgang.


 mailsendall
 Entspricht dem Knopf "Alle senden". RESULT enthält die Anzahl der 
 gesendeten Nachrichten oder -1, falls die Verbindung mit dem Postserver
 nicht zustande kam.



 _____________________________Verschiedenes_____________________________


 getconfiginfo INFO/A
 Gibt Informationen zur Konfiguration in der Variable RESULT zurück.
 INFO ist eines der folgenden Schlüsselwörter:
   NAM(E)    Ihr richtiger Name
   EMA(IL)   Ihre Email-Adresse


 mailupdate
 Entspricht dem Menüpunkt "Postfach/Index aktualisieren".


 request       BODY/A,GADGETS/A
 Öffnet ein Abfragefenster auf dem YAM-Bildschirm und wartet auf eine
 Eingabe durch den Benutzer. BODY ist der im Abfragefenster erscheinende
 Text, GADGETS sind die Beschriftungen eines oder mehrerer Knöpfe, getrennt
 druch |. RESULT enthält die Nummer des ausgewählten Knopfs (1,2,...,0).
 Beispiel:  request 'Wollen Sie beenden' 'Ja|Weiss nicht|Nein'




 BEISPIEL


 Folgendes Skript durchsucht das Postarchiv nach allen Nachrichten mit dem
 Betreff "YAM Registrierung" und gibt deren Absender aus:


 /* register.rexx */
 OPTIONS RESULTS
 ADDRESS YAM
 SetFolder 3                                  /* Archiv-Postfach wählen */
 GetFolderInfo MAX; eintraege = RESULT        /* Anzahl Mails abfragen  */
 DO i=0 TO eintraege-1                        /* Gehe alle Mails durch  */
   SetMail i                                  /* Aktuelle Mail setzen   */
   GetMailInfo SUBJECT                        /* Betreff abfragen       */
   IF RESULT = 'YAM Registrierung' THEN DO    /* Kriterium erfüllt?     */
     GetMailInfo FROM                         /* Absender Abfragen und  */
     SAY RESULT                               /* ausgeben               */
   END
 END